home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 010a / dta161.zip / DTA.DOC < prev   
Text File  |  1991-10-03  |  14KB  |  278 lines
  1.  
  2.                                    DTA.DOC
  3.                                    -------
  4.                            Instructions for DTA.COM
  5.                           Version 1.61 (3 Oct 1991)
  6.  
  7.                              (c)1987-91 E. Meyer
  8.  
  9.  
  10.      DTA.COM is a super directory utility that will run on any PC/MSDOS system 
  11. (version 2 or higher).  "DTA" stands for Directory-Tree-Attributes; it is a 
  12. replacement for the DIR, TREE, and ATTRIB commands of DOS, as well as a 
  13. WHEREIS utility.  Though small, DTA has many features including:
  14.  
  15.     *  alphabetized color directory with file sizes and free space
  16.     *  optional wide mode or full mode (with attributes and time/date)
  17.     *  select items to display by attributes, time/date, or file size
  18.     *  display several groups of files, or all except certain files
  19.     *  change any file attributes or time/date
  20.     *  treat directories either separately or together with files
  21.     *  alphabetized compact directory tree; optional full mode with sizes
  22.     *  optionally search entire drive (all directories) for files
  23.  
  24.      The syntax and options of DTA are compatible with my ARCOPY (archive/ 
  25. copy), DIRCMP (directory compare), and DLT (delete) utilities, which work well 
  26. together.
  27.  
  28.  
  29.                                   USING DTA
  30.                                   ---------
  31.  
  32. SYNTAX:    A>dta {fspec1} {{,}fspec2...} {/options}           ("{}"=optional)
  33.  
  34.         where  each "fspec" may include a drive, path, or wildcards;
  35.                either spaces or commas may separate multiple filespecs;
  36.                "/" is the delimiter for option letters.
  37.  
  38.      If the drive or path is omitted from the first filespec, it defaults to 
  39. the current DOS value; for subsequent ones, to the same as the previous one.  
  40. If the filespec is omitted it defaults to "*.*".  If it is a directory name, 
  41. the contents of the directory are displayed.
  42.      Options are discussed in detail below.  If none are specified, you will 
  43. get a compact, informative directory display.
  44.  
  45.      You can pause or abort during operation of DTA by typing ^S or ^C.  
  46. Output can be directed to a file or other device in the standard fashion:
  47.                 A>DTA FILESPEC /OPTIONS >DEVICE.
  48.  
  49.  
  50.                            INTERPRETING THE DISPLAY
  51.                            ------------------------
  52.  
  53.      SIZES are measured in kilobytes (1k is 1024 bytes) or megabytes (1m is 
  54. 1024k, or 1,048,576 bytes).  DTA displays them in kilobytes up to 999k; beyond 
  55. that, to the nearest tenth of a megabyte (1.0m, etc).  The "items total" 
  56. amount is simply the sum of the individual file sizes shown; the "items use" 
  57. amount is the total disk space those files actually occupy.  (If any 
  58. directories are shown, the sizes of their contents are not included.)  Because 
  59. allocation clusters on a disk can vary from 128 bytes (on a RAMdisk) to 4k (on 
  60. a hard disk), the space consumed by each file can be a fraction of a k less or 
  61. several k more than its displayed size; thus, depending on disk media, the 
  62. "use" amount may be a bit less, or significantly more, than the "total" of the 
  63. displayed sizes.  The "used/free" space shown by DTA is for the entire drive.
  64.  
  65.      ATTRIBUTES, when displayed, show as a letter ("A,H,R,S") if set, or as 
  66. "." if clear.  The Archive attribute indicates to a backup utility that a file 
  67. has been changed recently, and needs to be backed up; the bit is cleared by 
  68. the utility when it does so.  (Simple backup utilities that work well with DTA 
  69. include the DOS XCOPY command, and my own ARCOPY.COM.)
  70.      The Read/only attribute prevents a file from being changed or deleted, 
  71. though it can be read and copied.  The Hidden and System attributes both 
  72. exclude items from normal searches: they cannot be accessed at all by ordinary 
  73. MSDOS file commands.  Ordinarily only the DOS boot files MSDOS.SYS and IO.SYS 
  74. have these attributes.  (If you do NOT want to see hidden or system items, use 
  75. "/sh".)
  76.  
  77.      TIME/DATE, when displayed, appears in US format unless you have changed 
  78. this default, or another format (Euro,Num) was used with the /B,/L,/@ options.
  79.  
  80.  
  81.                                  DTA OPTIONS
  82.                                  -----------
  83.  
  84.      By default, DTA will display a list of all files specified, along with 
  85. their sizes, and some disk space information.  You can modify this consid- 
  86. erably with a variety of options.  One "/" must precede any options; further 
  87. slashes may be used or not, as desired.
  88.  
  89.      /? = help.  Gives version message, brief summary of usage and options.
  90.  
  91. There are options to scan the directory tree, instead of the current dir:
  92.      /T = tree: show it, starting at specified or current directory.
  93.      /G = global: search for specified files throughout the tree.
  94.  
  95. Then there are options affecting the appearance of the display:
  96.      /F = full: for directory, show attributes and time/date also.
  97.                   (automatically selected for single file display)
  98.                 for tree/global search, show file size information.
  99.      /W = wide: just like DIR /W, five columns with no file sizes.
  100.      /N = narrow: use only half the usual number of columns.
  101.      /P = pause: after every 24 lines, pause for a keystroke.
  102.  
  103. Then there are options to select what items are chosen for display:
  104.      /X = except: select only items other than those named.
  105.      /D = directories: select directories instead of files.
  106.      /U = universal: select both directories and files.
  107.      /B = before: select files before specified date,time.
  108.      /L = later: select files later than specified date,time.
  109.      /K = size: select files by specified size ("+"=greater, "-"=less).
  110.      /A,H,R,S = select only items with the specified attributes:
  111.                  Archive; Hidden; Read/only; System.
  112.      /a,h,r,s = select only items WITHOUT these attributes.
  113.  
  114. Finally, you can specify:
  115.      /@ = set time stamp on items to date,time.
  116.      /C = change items to have the following specified attributes.
  117.  
  118.      Be careful with the /@,/C options, because they actually CHANGE the DOS 
  119. time stamp and attributes for files!  Time stamps, especially, provide 
  120. valuable information about the age and revision of a file, and should not be 
  121. changed without good reason.
  122.  
  123.      With the /B,/L,/@ options, the date and/or time should follow the option 
  124. letter; if both are specified, separate them with a comma.  If the time is 
  125. omitted, it defaults to 0 hours (12 AM); if the date is omitted, it defaults 
  126. to TODAY.  If both are omitted, /@ defaults to today, now; /B,/L default to 
  127. today, 0 hours.  DTA recognizes U.S., European, and Numeric formats for 
  128. entering each, by the punctuation used:
  129.        U.S.(M/D/Y,H:MMa-p)    Euro (D.M.Y,H:MM)     Num (Y-M-D,HHMM)
  130.           3/25/90,1:45p    =    25.3.90,13:45    =    90-3-25,1345
  131. (If you add the /A or /P option after a Euro format time, insert a slash or 
  132. space so it doesn't look like a U.S. format time.)  The date "00/00/00" may be 
  133. used to set a blank or zero timestamp; otherwise the year must be 80 or above.
  134.  
  135.      With the /K option, the file size in "k" (from 0 to 999) should follow 
  136. the option letter; files of that size only will be listed.  Add a "-" after 
  137. the size to include smaller files as well, or a "+" to include larger ones.
  138.  
  139.      Note that the file attribute options are case sensitive (uppercase=set, 
  140. lower=clear).  Those listed alone, or before the "C" option letter, are used 
  141. for file selection; those after it, represent changes to be made.  The /C 
  142. option can also be used alone, with NO following attributes, simply to cause 
  143. attributes to display instead of file sizes (no attributes will be changed).
  144.  
  145.      The options /T,G,X do not allow multiple arguments; and a number of 
  146. combinations of options are invalid (/U or /D with /K,E,L,G; /T,G,X with one 
  147. another; /G with /@,C; etc).
  148.  
  149.      The best way to make DTA usage clear will be by a series of examples.
  150.  
  151.  
  152.                        EXAMPLES: FILES and DIRECTORIES
  153. C>dta a:\*.doc *.txt
  154.   Show all files *.DOC and *.TXT in the root directory on A:.
  155. C>dta a:\*.sys /xf
  156.   Show all files EXCEPT *.SYS, with "full" display (attributes and time/date).
  157. C>dta /d
  158.   Show all subdirectories in the current directory.
  159. C>dta \work /u
  160.   Show all files AND subdirectories in C:\WORK.
  161.  
  162.                         EXAMPLES: SIZES and TIMESTAMPS
  163. C>dta d: e: /k0
  164.   Show only empty (0k) files in the current directory on drives D: and E:.
  165. C>dta \work /l
  166.   Show only files in directory C:\WORK created or modified since... today.
  167. C>dta /b9/1/89
  168.   Show only files in current directory dated before 9/1/89.
  169. C>dta *.doc /l/b1700
  170.   Show only files *.DOC dated today before 5:00 PM.
  171. C>dta log /@1.9.89,13:20
  172.   Modify the file LOG to have the timestamp 9/1/89, 1:20 PM.
  173.  
  174.                              EXAMPLES: ATTRIBUTES
  175. C>dta /c
  176.   Show all files in current directory with their attributes.
  177. C>dta /A
  178.   Show only files in current directory marked with the Archive attribute.
  179. C>dta a: /SH
  180.   Show only files in current directory on A: which are System and Hidden.
  181. C>dta a:*.sys /Hca
  182.   Select only Hidden files *.SYS on A: and clear their Archive attribute.
  183.  
  184.                        EXAMPLES: TREE and GLOBAL SEARCH
  185. C>dta \work /tp
  186.   Show the directory tree starting from C:\WORK, pausing after each screenful.
  187. C>dta *.bak /gk100+
  188.   Show all directories on drive C: containing files *.BAK of 100k or larger.
  189.  
  190.                                      QUIZ
  191.  
  192.      All right, can you decide what the following commands would accomplish:
  193.               A>dta /fun >prn           B>dta a: /c /p
  194.               A>dta *.xyz /lsAca        C\SUE\WORK>dta \ /f/d/H
  195.               C\SUE\WORK>dta ../tf      B>dta *.bak /xbk9-@
  196. (If this seems cryptic at first, you'll catch on.  You probably won't need all 
  197. these options; many exist only to allow you to get hard copy exactly the way 
  198. you want it.  Again, you can always type "DTA /?" for help.)
  199.  
  200.  
  201.                                CUSTOMIZING DTA
  202.                                ---------------
  203.  
  204.      You can use DEBUG or a similar utility to change DTA's default time/date 
  205. format, as well as text colors (on IBM PC compatibles).  Use of contrasting 
  206. colors can make the display more easily readable.  All values below are in 
  207. hexadecimal.
  208.  
  209.    ADDRESS    ORIGINAL
  210.  IN DTA.COM    VALUE      FUNCTION               POSSIBLE VALUES
  211.     0102         01     Default format    00=numeric, 01=US, 02=European
  212.     0103         01     Use color?        01=test, 00=NO, FF=YES
  213.     0104         07     Message color     00-FF \
  214.     0105         0F     Name color        00-FF  >see below
  215.     0106         07     Attribute color   00-FF /
  216.  
  217.      COMPATIBILITY:  With 0103 set to 01, DTA can usually detect whether it's 
  218. running on a PC compatible and should use color.  If it fails to recognize 
  219. your computer properly, or you simply don't want color output, you can 
  220. override the test by changing 0103 to 00 or FF, for No or Yes.
  221.  
  222.      COLORS:  Specify each color by a pair of hex digits for background and 
  223. foreground, according to the following codes:
  224.          0 = BLACK   4 = red       8 = GREY           C = bright red
  225.          1 = blue    5 = magenta   9 = bright blue    D = bright magenta
  226.          2 = green   6 = brown     A = bright green   E = yellow
  227.          3 = cyan    7 = WHITE     B = bright cyan    F = BRIGHT WHITE
  228. For example, "17" means "blue background, white text".
  229.      All monochrome screens can display black, white, and bright white; in 
  230. some cases, grey may also be visible.
  231.      Colors 8-F should generally be avoided as background colors because they 
  232. produce blinking video.  On EGA/VGA displays, if blinking video is disabled, 
  233. the whole range of background colors will be available.
  234.  
  235.      EXAMPLE:  To change to numeric time/date format as default, type "DEBUG 
  236. DTA.COM", then "E0102 00", then "W", then "Q".
  237.  
  238.      Please distribute copies of DTA with original settings only, to avoid 
  239. confusing other users.
  240.  
  241.  
  242.  
  243.                                 ERROR MESSAGES
  244.  
  245.      "<out of memory>" - Not enough free memory to run DTA, or over 1000 items 
  246. to list (try a more restrictive filespec).
  247.  
  248.      "<invalid argument>" - Invalid or conflicting option, bad path, illegal 
  249. character in filename, that sort of thing.  Think and try again.
  250.  
  251.      "0 items" - No such file (or directory) was found.  (If you expected 
  252. there to be some, check your arguments again...)
  253.  
  254.  
  255.                                    HISTORY
  256.  
  257.  DA 1.0 (Sep87) - First release, based on my previous CP/M utility DA.
  258.     1.1 (Aug88) - Improved parsing; select AND change attributes; new options.
  259. DTA 1.2 (Oct88) - Added /T tree option; DA is now called DTA.
  260.     1.3 (Sep89) - Added /G search, /E,L,@ options for time/date.
  261.     1.4 (Mar90) - Added /X (except) option; removed /V (version) option.
  262.     1.5 (May91) - US/Euro/Numeric date,time; /E changed to /B(efore).
  263.     1.6 (Sep91) - Multiple filespecs; added /K (size) option; file selection
  264.                     options work with /G; improved, color display.
  265.     1.61(Oct91) - Minor display fixes.
  266.  
  267.  
  268.      DTA and its documentation are (c)1987-91 Eric Meyer, all rights reserved.  
  269. They may be freely distributed, but not modified or sold for profit without my 
  270. written consent.  (Libraries may charge no more than $6 for a disk.)  The user 
  271. takes full responsibility for any damages resulting from the use of this 
  272. program.
  273.  
  274.                  Eric Meyer
  275.               3541 Smuggler Way              CompuServe [74415,1305]
  276.            Boulder, CO  80303  USA
  277.  
  278.